package org.example.flea_market_mvc.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.example.flea_market_mvc.entity.Categories;
import org.example.flea_market_mvc.param.CategoryParam;

import java.util.List;

/**
 * 商品分类Mapper接口，提供商品分类相关的数据库操作方法
 */
@Mapper
public interface CategoriesMapper {

    /**
     * 插入一条商品分类记录
     * @param categories 商品分类实体对象
     * @return 插入成功返回1，失败返回0
     */
    int insert(Categories categories);

    /**
     * 根据分类ID删除商品分类记录
     * @param id 分类ID
     * @return 删除成功返回1，失败返回0
     */
    int deleteById(Integer id);

    /**
     * 更新商品分类记录
     * @param categories 商品分类实体对象，包含要更新的信息
     * @return 更新成功返回1，失败返回0
     */
    int update(Categories categories);

    /**
     * 根据分类ID查询商品分类记录
     * @param id 分类ID
     * @return 商品分类实体对象，如果未找到则返回null
     */
    Categories selectById(Integer id);

    /**
     * 查询所有商品分类记录
     * @return 商品分类记录列表
     */
    List<Categories> selectAll();

    /**
     * 分页查询分类
     */
    List<Categories> selectPage(CategoryParam param, int offset, int pageSize);

    /**
     * 根据条件统计分类总数
     */
    int countByParam(CategoryParam param);
}